home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 3 / Amiga Format CD03 (1996-07-04)(Future Publishing)(GB)(Track 1 of 6)[!][issue 1996-08].iso / utilities / disksalv2 / locale / docs / english / disksalv.doc next >
Text File  |  1996-05-20  |  45KB  |  1,057 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.            DDD  III SSSS K  K SSSS   A   L  V   V      222 
  19.            D  D  I  S    K K  S     A A  L  V   V         2
  20.            D  D  I  SSSS KK   SSSS A   A L  V   V        2 
  21.            D  D  I     S K K     S AAAAA L  V   V       2  
  22.            D  D  I     S K  K    S A   A L   V V       2   
  23.            DDD  III SSSS K  K SSSS A   A LLLL V        2222
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                The Original Amiga Disk Salvage Program
  35.  
  36.  
  37.               Recovering your data for over seven years
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                             Cheap Manual 
  49.                                  for 
  50.                               DiskSalv 
  51.  
  52.                               Version 2
  53.                             Revision 11.27
  54.                             July 13, 1993
  55.  
  56.                  Copyright ©1992, 1993 by Dave Haynie
  57.                          All Rights Reserved 
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. COPYRIGHT 
  70.  
  71.           This  manual  is  Copyright  ©1992, 1993 by Dave Haynie. All
  72. Rights Reserved.  As part of the DiskSalv2 11.27 release, this  manual
  73. may  be  used  in  electronic or printed form along with the DiskSalv2
  74. program.  It may not be sold in any form, though a reasonable  copying
  75. and  handling  charge is acceptable, as long as the complete DiskSalv2
  76. distribution is included.  
  77.  
  78.  
  79. DISCLAIMER 
  80.  
  81.           The information and the DiskSalv program  are  provided  "as
  82. is" without  warranty  of  any kind, either expressed or implied.  The
  83. entire risk as to the accuracy of the information herein is assumed by 
  84. you.   Dave  Haynie  does  not  warrant,  guarantee,   or   make   any
  85. representations  regarding  the  use of, or the results of the use of,
  86. the information or the  DiskSalv  program  in  terms  of  correctness,
  87. accuracy, reliability,  currentness,  or  otherwise.  In no event will
  88. Dave  Haynie  be  liable  for   direct,   indirect,   incidental,   or
  89. consequential  damages resulting from any defect in the information or
  90. the DiskSalv program even if he has been advised of the possibility of 
  91. such damages.  
  92.  
  93.  
  94. CREDITS 
  95.  
  96.           This manual was prepared with anro, an nroff-like utility by 
  97. Steve Anderson. With all the sophisticated word processors and DTPs  I
  98. have  around,  I couldn't find anything that would simply give me some
  99. formatted ANSI text.  Until everyone has a way to deal with  IFF-FTXT,
  100. ANSI  will  remain  the only printer independent formatted text format
  101. available.  
  102.  
  103.           Amiga, AmigaDOS, Intuition,  KickStart,  and  Workbench  are
  104. trademarks of Commodore-Amiga, Inc.  
  105.  
  106.           The  DiskSalv  program,  its code, this manual, the DiskSalv
  107. icons, and  anything  else  distributed  with  this  package  are  the
  108. original  work  of  Dave  Haynie. Thanks go out to the Commodore-Amiga
  109. Software Engineering group for suggestions on  the  DiskSalv  GUI  and
  110. other Amiga  software  standards.    Countless  others  assisted  with
  111. suggestions, testing, and miscellaneous feedback which has also proved 
  112. invaluable.  
  113.                              -Dave Haynie
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. DiskSalv Version 2 Release 11.27                                Page 3
  134.  
  135. 0. INTRODUCTION 
  136.  
  137.           DiskSalv Version 2 is a disk recovery program for all  Amiga
  138. file  system  devices  that  use any of the 2.04/2.1/3.0 file systems.
  139. DiskSalv will scan (analyze) a bad disk volume for anything  that  can
  140. be recovered, and will restore these items to any AmigaDOS volume.  It 
  141. can   also   attempt   to  fix  a  bad  volume  in  place  under  most
  142. circumstances.   DiskSalv  is  a  complete  redesign  of  the  orignal
  143. DiskSalv  program,  with  a  new  AmigaDOS-2.0-compliant  command-line
  144. interface, new Intuition interface, and tons of new features.  
  145.  
  146.           This is designed to be a fairly  complete,  quickly  written
  147. and minimally  edited  manual  of  DiskSalv Version 2's features.  The
  148. built-in help system works as an adjunct to this, and it works  simply
  149. --  press the HELP key with the mouse positioned over something, and a
  150. short description of that something will pop up in a requester.  
  151.  
  152.           Better documentation is planned, but it won't be free.   I'm
  153. currently  working  on  a  professional  quality manual with pictures,
  154. better "how to", "why bother", and "theory of it all"  sections.    Of
  155. course, the  operative  phrase  here is "currently working".  It ain't
  156. done yet.  I hope to complete it by the time I do a general  shareware
  157. release.   Since  it will be several megabytes of PostScript output by
  158. the time its done, and I really  have  no  philosphical  objection  to
  159. making  a little beer money here and there, this will be offered up as
  160. a printed manual as part of a  semi-commercial  version  of  DiskSalv.
  161. This  is  all  explained  in the "Licensing and Distribution" section.
  162. Additionally, the core  of  that  manual  will  become  an  AmigaGuide
  163. manual, and that will come with the printed version.  I just figured I 
  164. would  mention  this  all here before confusing you with the quick and
  165. dirty version to follow.  
  166.  
  167.  
  168. 1. STARTING UP 
  169.  
  170.           DiskSav Version 2 (from here on referred to  as  "DiskSalv")
  171. is a  program designed to "salvage" damaged hard disks.  There are two
  172. basic   classes   of   salvage   operation,   "Recover-by-Copy"    and
  173. "Fix-in-Place".  In  the  former  case,  DiskSalv  analyzes a disk and
  174. attempts to restore any files and directories from a damaged  AmigaDOS
  175. file system  device  to  a  good  one.    In the latter case, DiskSalv
  176. attempts to find faulty disk objects and remove them from  the  disk's
  177. directory/file  hierarchy  so that the disk's FileSystem will validate
  178. it.  
  179.  
  180.  
  181. 1.1 CLI OPERATION 
  182.  
  183.           In the simplest case, DiskSalv can be used  very  much  like
  184. DiskSalv  V1.42,  the  AmigaDOS  "DiskCopy"  program, or any number of
  185. other CLI-based programs.  The user simply  types  a  command  at  the
  186. command line,  and  the program goes to work.  For example, to recover
  187. files from a bad disk in DH0: and restore them on a  good  disk  DH1:,
  188. the user will type: 
  189.  
  190.           1> DiskSalv FROM DH0: TO DH1: 
  191.  
  192. Here the "FROM" and "TO" required CLI keywords.  There are quite a few 
  193. more  keywords,  which control a good portion of DiskSalv's operation.
  194. However, to access every feature, it's necessary to  use  the  program
  195. interactively  under  Intuition. The AmigaDOS template is displayed as
  196.      follows: 
  197.  
  198.  
  199. Page 4                                DiskSalv Version 2 Release 11.27
  200.  
  201.      DiskSalv Version 2 Copyright (c) 1991-1993 by Dave Haynie
  202.  
  203.      FROM/K, TO/K, MODE/K, FILESYSTEM/K, DEFAULTFS/K, TAGCHAR/K,
  204.      PUBSCREEN/K, MEMCHUNK/N, PATHMAX/N, DISKCACHE/N, LOWMEM/S,
  205.      NOSIZECHECK/S, QUICKSCAN/S, NOWARNING/S, NODATES/S, NONOTES/S,
  206.      NOPROTECT/S, KEEPDOS/S,KILLDOS/S, NODEEPSCAN/S, INTERACTIVE/S,
  207.      REJECTION/N, MAKELINKS/S,S MALLWINDOW/S, BIGBLOCKS/T
  208.  
  209. The meaning of these keywords is given below.  Note that  any  keyword
  210. can also be used as an icon variable (tooltype).  
  211.  
  212.      FROM 
  213.           The  "FROM"  keyword  specifies  an input device, the device
  214.           that will be operated on.  This must be a DOS device, not  a
  215.           subdirectory  or  assignment, and it must be based on one of
  216.           the standard file systems with underlying device driver.  
  217.  
  218.      TO 
  219.           The "TO" keyword specifies an output device, the device that 
  220.           will receive any recover-by-copy files that DiskSalv  finds.
  221.           This  may  be  any AmigaDOS device, volume, or subdirectory.
  222.           If a non-existant subdirectory is  specified,  one  will  be
  223.           generated.  
  224.  
  225.      MODE 
  226.           There  are  several  kinds  of  functions that DiskSalv will
  227.           run.  The default is "Salvage",  which  causes  DiskSalv  to
  228.           work  just  like  the  original  DiskSalv. Other modes cause
  229.           other actions: 
  230.  
  231.      SALVAGE 
  232.           This is  the  basic  Recover-by-Copy  function.     DiskSalv
  233.           attempts  to  restore  every  file  it  finds from the input
  234.           device to the output device.  The user can select the  files
  235.           to actually restore.  
  236.  
  237.      UNDELETE 
  238.           This is  another  Recover-by-Copy  function.   It is used on
  239.           undamaged partitions to find deleted files.   The  user  can
  240.           interactively pick which files are actually restored in this 
  241.           way.  
  242.  
  243.      VALIDATE 
  244.           This is  the  simplest Fix-In-Place function.  It can repair
  245.           an device that  hasn't  been  severely  damaged.    On  most
  246.           devices,  the  scan  used  in  this mode is much faster than
  247.           other scans, but it can slow down on very large volumes.  As 
  248.           with all Fix-In-Place  functions,  any  file  that  must  be
  249.           eliminated  from  disk will be displayed in a file list once
  250.           the fix operation has completed.  
  251.  
  252.      REPAIR 
  253.           This is a more advanced Fix-In-Place function.   It  does  a
  254.           traditional  DiskSalv  scan, and it can find more files than
  255.           the Validate function can.  It can also live with partitions 
  256.           that are more damaged than those Validate will handle.  
  257.  
  258.      UNFORMAT 
  259.           This function runs a Fix-In-Place operation on a  disk  that
  260.           has      been      accidently      formatted      (hopefully
  261.           non-destructively).  It's similar to Repair, but it  assumes
  262.           that the disk root is invalid.  
  263.  
  264.  
  265. DiskSalv Version 2 Release 11.27                                Page 5
  266.  
  267.      FILESYSTEM 
  268.           This  allows  the  user to specify the file system to use on
  269.           the input device.    Normally,  DiskSalv  will  determine  a
  270.           partition's file  system  from  its root block.  If for some
  271.           reason that information is unavailable or wrong, this allows 
  272.           the file system type to be specified by force.  
  273.  
  274.                OFS 
  275.                     Original AmigaDOS FileSystem.  
  276.  
  277.                FFS 
  278.                     1.3-compatible Fast FileSystem.  
  279.  
  280.                OFS Intl.  
  281.                     International character set aware version of  OFS.
  282.                     International   file   systems  treat  diacritical
  283.                     characters  properly  with  respect  to  the  case
  284.                     independence expected in an Amiga file system.  
  285.  
  286.                FFS Intl.  
  287.                     International character set aware version of FFS.  
  288.  
  289.                DC-OFS 
  290.                     Directory   caching   version  of  OFS.  Directory
  291.                     caching  file  systems  keep  a  secondary  packed
  292.                     record  of  file  data  to  provide fast directory
  293.                     listings.  
  294.  
  295.                DC-FFS 
  296.                     Directory caching version of FFS.  
  297.  
  298.                Best-Guess 
  299.                     DiskSalv will pick one of the FileSystems it knows 
  300.                     about, based on  an  analysis  of  the  disk  done
  301.                     during the Scan. This is the standard default file 
  302.                     system  (eg,  default  if  no alternate default is
  303.                     selected).  
  304.  
  305.      DEFAULTFS 
  306.           This allows the user to specify the fallback  FileSystem  to
  307.           use on  the input device.  Normally, DiskSalv will determine
  308.           a partition's FileSystem from its root block,  but  if  that
  309.           root block is damaged, DiskSalv needs this fallback.  
  310.  
  311.      TAGCHAR 
  312.           This  allows  the user to specify which character to use for
  313.           tagging selected files on the Output  screen  file  browser.
  314.           The default is '*'.  
  315.  
  316.      PUBSCREEN 
  317.           This  specifies  the  public screen for DiskSalv to start up
  318.           on.  If none is specified, DiskSalv will  start  up  on  the
  319.           Workbench screen (eg, default public screen).  
  320.  
  321.      MEMCHUNK 
  322.           This  specifies  the memory chunk size for DiskSalv's chunky
  323.           allocator to use.  By default, this is 4K, and  can  be  set
  324.           between 1K and 128K.  
  325.  
  326.      PATHMAX 
  327.           This specifies  the  maximum  length  of  a  file path.  The
  328.           default value is 512 bytes, and can be set between 256 bytes 
  329.  
  330.  
  331. Page 6                                DiskSalv Version 2 Release 11.27
  332.  
  333.           and 4K.  
  334.  
  335.      DISKCACHE 
  336.           This specifies the number of blocks to be used for the  disk
  337.           cache (which  is  actually a pre-fetch buffer).  The default
  338.           size is 8 blocks, and can be set between 0  (no  cache)  and
  339.           255 blocks.  
  340.  
  341.      LOWMEM 
  342.           This specifies  low-memory  mode.    If DiskSalv runs out of
  343.           memory on a system in normal mode, it may be  successful  in
  344.           low-memory mode.    This  automatically  causes  the  chunky
  345.           allocator, file path buffer, and disk cache to go to minimum 
  346.           sizes.  It cuts out a number of other internal  things  that
  347.           generally just affect performance rather than success.  
  348.  
  349.      NOSIZECHECK 
  350.           This  inhibits automatic size checking of the output volume.
  351.           Normally, DiskSalv watches the size of the output volume  to
  352.           have an idea ahead of time that a volume will fill up.  Some 
  353.           devices,  such  as  RAM:,  are  dynamically sized and always
  354.           indicate full  when  asked,  so  this  parameter  is  mainly
  355.           intended  for  such  devices (DiskSalv actually invokes this
  356.           automatically for RAM:, but it would have  to  be  specified
  357.           manually for other such devices).  
  358.  
  359.      QUICKSCAN 
  360.           This specifies  a faster disk scanning mode.  The speed of a
  361.           disk  scan  is  improved  by  cutting  down  on  the  visual
  362.           display.   DiskSalv will still show a "gas-guage" indicator,
  363.           but it won't list objects as they are encountered.  
  364.  
  365.      NOWARNING 
  366.           DiskSalv will normally attach a warning or error message, as 
  367.           a FileNote, to any file it restores  via  a  Recover-by-Copy
  368.           operation that  it  considers  suspect  or bad.  This option
  369.           will inhibit such action.  
  370.  
  371.      NODATES 
  372.           This option will inhibit restoration of  the  original  file
  373.           date in Recover-by-Copy operations.  
  374.  
  375.      NONOTES 
  376.           This   option  will  inhibit  restoration  of  the  original
  377.           FileNote in Recover-by-Copy operations (though warning notes 
  378.           will override original notes).  
  379.  
  380.      NOPROTECT 
  381.           This  option  will  inhibit  restoration  of  the   original
  382.           protection codes in Recover-by-Copy operations.  
  383.  
  384.      KEEPDOS 
  385.           The FileSystem (eg, AmigaDOS) is usually locked out from the 
  386.           input device  during  scan  and  recovery  operations.  This
  387.           option will prevent such a lockout.  Fix-In-Place operations 
  388.           are not affected by  this,  as  they  absolutely  require  a
  389.           FileSystem  lockout since they are modifying the input disk.
  390.           Note that allowing any writes to the  input  disk  during  a
  391.           DiskSalv  operation  will almost certainly cause DiskSalv to
  392.           malfunction.  
  393.  
  394.      KILLDOS 
  395.  
  396.  
  397. DiskSalv Version 2 Release 11.27                                Page 7
  398.  
  399.           This option forces DiskSalv to do its job without using  any
  400.           device  directed  DOS  functions  or  file  system  packets.
  401.           Normally, DiskSalv uses a handfull of DOS library  functions
  402.           on input  disks.  This is designed to make DiskSalv safe for
  403.           use on disks that crash  AmigaDOS  or  the  particular  file
  404.           system in  use.   This is a somewhat dangerous option, since
  405.           it prevents DiskSalv from locking the file system out  of  a
  406.           device (since that requires a file system packet).  It works 
  407.           best  on  devices  that  can't  be given to AmigaDOS because
  408.           they're too damaged.  Note that DOS is automatically avoided 
  409.           on unmounted devices.  
  410.  
  411.      NODEEPSCAN 
  412.           This inhibits extra low-level  processing  from  being  done
  413.           floppy disks.  Such processing can recover data not normally 
  414.           accessable through the trackdisk.device, but it causes extra 
  415.           memory to be used.  
  416.  
  417.      INTERACTIVE 
  418.           This  forces  DiskSalv  into  interactive  operation (eg, it
  419.           waits for user input).  When run from the CLI, DiskSalv will 
  420.           by default do as much as  it  can  non-interactively  before
  421.           going into interactive mode.  
  422.  
  423.      REJECTION 
  424.           This  specifies  a  filter  strength, between 1 and 10, that
  425.           influences DiskSalv's assessment of whether or  not  a  disk
  426.           block matches a specific block type.  This is generally left 
  427.           at the default, 6.  
  428.  
  429.      MAKELINKS 
  430.           This  causes DiskSalv to actually create links on the output
  431.           volume.  Normally it instead creates  a  script  file  which
  432.           will create the links.  
  433.  
  434.      SMALLWINDOW 
  435.           This  causes  DiskSalv  to  build a minimal scanning display
  436.           window, even on large screens.  
  437.  
  438.      BIGBLOCKS 
  439.           This lets the user specifiy  whether  support  for  multiple
  440.           sectors per   block   is   enabled.    On  pre-V39  systems,
  441.           occasionally DOS devices claimed for  some  reason  to  have
  442.           more than  one sector per block.  Since real support of this
  443.           didn't appear until the  V40  FileSystem,  which  apparently
  444.           needs  V39  to run, multiple sector per block support is off
  445.           by default in on a pre-V39 system, on  by  default  for  V39
  446.           systems and above.  
  447.  
  448.  
  449. 1.2 WORKBENCH OPERATION 
  450.  
  451.           DiskSalv can be run from the Workbench by double-clicking on 
  452. its  Icon.  Normally,  this  brings  up  DiskSalv interactively, where
  453. options are set via standard 2.0-level  Intuition  interface  objects.
  454. However,  any  of  the  command-line  parameters  may  be  set as Icon
  455. ToolTypes  to  set  DiskSalv  up   for   other-than-standard   default
  456. conditions and other special things.  
  457.  
  458.  
  459. 1.3 THE DISKSALV GUI 
  460.  
  461.  
  462.  
  463. Page 8                                DiskSalv Version 2 Release 11.27
  464.  
  465.           No  matter  how  you enter DiskSalv, you're going to wind up
  466. seeing some aspect of the program's  GUI.  If  you  run  interactively
  467. either  from  the  CLI  or  from  Workbench, you will start out in the
  468. "Input Window". Here is where various parameters are set that  control
  469. how the program will "scan", or learn about, a given input disk.  Once 
  470. all  input  information  is  set  up,  the  program moves to the "Scan
  471. Window",  which  basically  monitors  disk   scan   and   Fix-In-Place
  472. operation, where  applicable.  If it's appropriate (files are found in
  473. a  Recover-by-Copy  mode  or  damaged  files  are   found   during   a
  474. Fix-In-Place  operation), the Scan Window will give way to the "Output
  475. Window". This windows accepts input to select the objects that will be 
  476. restored and the device to restore them to.  
  477.  
  478.           While DiskSalv's interface is based on Intuition, there  are
  479. keyboard  equivalents for practically anything you can do from gadgets
  480. or windows.  The  gadget  shortcuts  are  generally  indicated  by  an
  481. inderlined  letter  in  the  text  of  the particular gadget, and will
  482. change from language to language.  For gadgets that cycle  or  scroll,
  483. the direction of movement will change based on whether the shortcut is 
  484. typed with  the  shift  key  pressed.  A few windows have gadgets with
  485. extra functions or non-text  gadgets  that  have  keyboard  shortcuts.
  486. Those  shortcuts  are  mentioned  in the this manual in the particular
  487. section relating to that gadet.  
  488.  
  489.           Menus also have keyboard shortcuts, which are always invoked 
  490. with the right Amiga key and a single letter pressed together.   These
  491. are indicated  in  the  menus,  in the normal Intuition fashion.  Note
  492. that these, too, can change  according  to  the  localization  of  the
  493. program, so the actual values aren't called out here.  
  494.  
  495.  
  496. 2.0 THE INPUT WINDOW 
  497.  
  498.           The Input Window is where a device is selected.  There are a 
  499. series  of gadgets and menu items that can control the way things work
  500. here.  The gadgets are as follows: 
  501.  
  502.      Device For Scan 
  503.           This list gadget displays a  list  of  recoverable  devices.
  504.           One of  these must be selected to run a scan.  These are all
  505.           listed  by  physical  AmigaDOS  name,  never  by  volume  or
  506.           assigned name.  
  507.  
  508.      FileSystem: 
  509.           This  gadget  is  a  cycle gadget that allows any of the six
  510.           aforementioned file systems to be selected.  When you select 
  511.           a device, this gadget will be set to DiskSalv's  best  guess
  512.           at  that  device's  file  system, or the default if DiskSalv
  513.           can't make a good guess.  Therefore, the  user  is  able  to
  514.           pick  a different one if DiskSalv didn't make a good choice.
  515.           See section 1.1, "FILESYSTEM", for a list  of  these.    The
  516.           "Best-Guess"  option  runs a special statistics tracking and
  517.           analysis routine to determine the most  likely  file  system
  518.           for any given device.  
  519.  
  520.      Mode: 
  521.           This  cycle  gadget  lets  the  user  select  an appropriate
  522.           recovery operation.  Interlocks are  managed  here  to  make
  523.           certain  that  the  specified operation and specified device
  524.           will work together.  See section 1.1, "MODE", for a list  of
  525.           the FileSystem names.  
  526.  
  527.  
  528.  
  529. DiskSalv Version 2 Release 11.27                                Page 9
  530.  
  531.      Set Filter...  
  532.           This  gadget  brings  up  the  "Disk  Scan  Filter  Options"
  533.           window.  This window allows various options  to  be  set  to
  534.           control  partial  scans  of  a  disk, exclusions by AmigaDOS
  535.           pattern name or protection bits, etc.  See section 2.1 for a 
  536.           full explanation of this window.  
  537.  
  538.      Device Info...  
  539.           This  gadget  brings  up  a  "Physical  Device  Information"
  540.           requester  which  gives  partitioning  and  other  low-level
  541.           information on the selected device.  
  542.  
  543.      Scan 
  544.           This gadget starts the disk analysis phase of  the  DiskSalv
  545.           program.   Once  the other phases are complete, the user may
  546.           return  to  the  Input  Window  without  having  to  restart
  547.           DiskSalv.  
  548.  
  549.           There  are  two  menus on the Input Window. One of these can
  550. call up a variety  of  miscellaneous  functions,  the  other  controls
  551. toggling  of a few control options, and the ability to save these back
  552. to the DiskSalv icon.  The mens are as follows: 
  553.  
  554.      Project/About...  
  555.           This item brings up a  requester  with  information  on  the
  556.           version   of   DiskSalv,   its  distribution  license,  some
  557.           Shareware data, and where to write me about DiskSalv.  
  558.  
  559.      Project/Help...  
  560.           This item brings up a requester with a brief explanation  of
  561.           the Input Window.  
  562.  
  563.      Project/Log File...  
  564.           This  item  brings up a file requester for the specification
  565.           of a log file.  This file must be on a device other than the 
  566.           input device.  When a log file is specified,  DiskSalv  will
  567.           write a record of its activity during all phases out to that 
  568.           file.  
  569.  
  570.      Project/Restore...  
  571.           This   item  brings  up  the  "Stream  Restoration  Options"
  572.           requester, which allows the user to specify input and output 
  573.           paths for restoration of a DiskSalv archive  file.    Please
  574.           see  section  3 for information on creating DiskSalv archive
  575.           files.  
  576.  
  577.      Project/Custom...  
  578.           This item brings up the "Custom Window". The  Custom  Window
  579.           is  an advanced option that can be used to search a disk for
  580.           logical  partitions  or  specify  partitions  based  on  the
  581.           low-level components.  
  582.  
  583.      Project/Save Device...  
  584.           This  item saves the currently selected "Device for Scan" as
  585.           a description file for the AmigaDOS Mount command.  
  586.  
  587.      Project/Load Device...  
  588.           This item loads a specified AmigaDOS device description file 
  589.           as a DiskSalv "virtual" device.  The name of the device will 
  590.           be the name of the description file.  
  591.  
  592.      Project/Quit 
  593.  
  594.  
  595. Page 10                               DiskSalv Version 2 Release 11.27
  596.  
  597.           This item closes the DiskSalv  program.    Its  function  is
  598.           identical  to  that of the Close gadget on the DiskSalv main
  599.           window.  
  600.  
  601.      Settings/DOS Lock 
  602.           The FileSystem (eg, AmigaDOS) is usually locked out from the 
  603.           input device during scan  and  recovery  operations.    This
  604.           option toggles  prevention  of such a lockout.  Fix-In-Place
  605.           operations are not affected  by  this,  as  they  absolutely
  606.           require  a  file system lockout since they are modifying the
  607.           input disk.  Note that allowing any writes to the input disk 
  608.           during a DiskSalv  operation  will  almost  certainly  cause
  609.           DiskSalv to malfunction.  
  610.  
  611.      Settings/Low Memory 
  612.           This option  toggles  low-memory mode.  If DiskSalv runs out
  613.           of memory on a system in normal mode, it may  be  successful
  614.           in low-memory  mode.    This automatically causes the chunky
  615.           allocator, file path buffer, and disk cache to go to minimum 
  616.           sizes.  It cuts out a number of other internal  things  that
  617.           generally just affect performance rather than success.  
  618.  
  619.      Settings/Small Window 
  620.           This option  toggles  automatic window sizing.  Normall, the
  621.           DiskSalv scanner will open a large window if  it  finds  the
  622.           current screen  supports  it.    This  will force use of the
  623.           small window for all scans, regardless of the screen size.  
  624.  
  625.      Settings/Quick Scan 
  626.           This option  selects  the  quick  scanning  option  for  the
  627.           scanner.   With  this  set,  the  scanning  process will run
  628.           faster by not displaying any data on the files  encountered.
  629.  
  630.      Settings/Save Settings 
  631.           This  options  saves  various  Input screen variables to the
  632.           DiskSalv tools icon.  
  633.  
  634.  
  635. 2.1 THE DISK SCAN FILTER OPTIONS WINDOW 
  636.  
  637.           The  "Disk  Scan  Filter  Options"  window  allows   several
  638. modifiers  to  be  set that affect the scan phase of a Recover-by-Copy
  639. operations.  These modifiers are ignored by  Fix-In-Place  operations,
  640. which must  examine  a disk in its entirety to perform correctly.  The
  641. window has standard "Ok" and "Cancel" gadgets, which  use  and  ignore
  642. the effect  of the current filter options settings, respectively.  The
  643. other gadgets are as follows: 
  644.  
  645.      File Pattern 
  646.           The string gadget takes in an AmigaDOS file pattern.  During 
  647.           the scan of a  disk,  any  file  matching  this  pattern  is
  648.           recorded, while any file not matching is ignored.  This acts 
  649.           on  links as well as files, but not on directories, since at
  650.           the time a directory is scanned, there's no way to  tell  if
  651.           it  will be needed by a child object that's further into the
  652.           disk.  
  653.  
  654.      Disk Scan Range 
  655.           This gadget is composed of two pointers, which can be  moved
  656.           to  modify  the  part  of  the  input  disk that is actually
  657.           scanned.  The start and finishing blocks on  that  disk  are
  658.           indicated next  to  the gadget.  The gadget is hard-wired to
  659.  
  660.  
  661. DiskSalv Version 2 Release 11.27                               Page 11
  662.  
  663.           make certain that  the  start  of  the  disk  is  below  the
  664.           finish.   This  can be moved from the keyboard with left and
  665.           right cursor keys, unshifted or shifted.  
  666.  
  667.      Protection Bits 
  668.           This is a group of gadgets which control  matching  of  each
  669.           file  encountered against the seven defined protection bits.
  670.           A "Don't Care" setting matches  any  level,  a  "Match  Set"
  671.           setting  matches  a  bit  that's logically set, and a "Match
  672.           Clear" setting matches a bit that's logically clear.  
  673.  
  674.  
  675. 2.2 THE CUSTOM WINDOW 
  676.  
  677.           The Custom Window is a fork  off  the  main  DiskSalv  Input
  678. Window that is used for dealing with special device cases.  An unknown 
  679. disk,  a  disk  with  lost  partitioning  information,  or  other such
  680. problems can  be  solved  here.    An  input  device  is  entered  via
  681. exec-level device  name  and  unit  number.   The user can specify the
  682. partitioning  information  or  ask  DiskSalv   to   go   looking   for
  683. partitions.   In  a  search,  the  partition's  logical  name  can  be
  684. specified as a search target, or DiskSalv can be  instructed  to  find
  685.           all partitions on the disk.  There are fifteen gadgets here: 
  686.  
  687.      Create 
  688.           The  Create  gadget builds one "virtual device" based on the
  689.           information supplied  here.    This   requires   the   basic
  690.           partitioning  information,  exec device name and unit, and a
  691.           DOS Name which  is  used  in  the  "Device  For  Scan"  list
  692.           gadget.   Any  such virtual device is listed in parentheses,
  693.           and only the "Salvage" operation can be used on them.  
  694.  
  695.      Search 
  696.           This function starts a search on  the  given  disk  for  one
  697.           volume that matches the given pattern.  
  698.  
  699.      Analyze 
  700.           This function starts a scan of the defined range of the disk 
  701.           for any  partitions.   The base block of a partition will be
  702.           used as its name if no root is found.  If a root  is  found,
  703.           its  name  will  be  used  instead  in the "Device For Scan"
  704.           list.  
  705.  
  706.      Cancel 
  707.           Leave this window without performing any kind of scan.  
  708.  
  709.      Device Name: 
  710.           This is the Exec device used to manage  the  disk,  such  as
  711.           "scsi.device".  Be very careful in selecting this properly.  
  712.  
  713.      Name/Pattern: 
  714.           This  is  a  DOS Name for "Created" volumes, or a pattern to
  715.           apply to a search for a specific volume or as a  volume-name
  716.           filter for full analysis.  
  717.  
  718.      Unit: 
  719.           The  unit number for the Exec device names in "Device Name".
  720.           Be very careful in selecting this properly.  
  721.  
  722.      Sectors/Track: 
  723.           This is the number of sectors assigned per disk track.  
  724.  
  725.  
  726.  
  727. Page 12                               DiskSalv Version 2 Release 11.27
  728.  
  729.      Bytes/Sector: 
  730.           This is the basic block size for the  device.    While  most
  731.           things  in the system are set up for 512 byte blocks, larger
  732.           disks may  use  larger  block   sizes.      These   are   in
  733.           powers-of-two, 512 bytes or larger.  
  734.  
  735.      Sectors/Block: 
  736.           This  parameter  allows  for a variable effective block size
  737.           per  partition  while  having   a   consistent   number   of
  738.           bytes/sector throughout a disk.  Block size is Sectors/Block 
  739.           * Bytes/Sector. By default, this is only available under V39 
  740.           or later file systems.  
  741.  
  742.      Low Sector: 
  743.           This  is  the  starting  position  on the input device to be
  744.           searched.  Since we're not searching a logical partition but 
  745.           in fact a physical disk, this number is a direct disk sector 
  746.           number (this specifies the physical block to map to  logical
  747.           block 0 for the Create operation).  
  748.  
  749.      High Sector: 
  750.           This is the last physical block to scan for all operations.  
  751.  
  752.      Flags: 
  753.           These are device-driver specific flags.  
  754.  
  755.      Memory Type: 
  756.           This  cycle  gadget  allows  the user to specify the type of
  757.           memory to use for disk  buffers.    Types  include  DEFAULT,
  758.           CHIP, FAST, and DMA-24.  
  759.  
  760.           There are only two menu items on the single menu attached to 
  761. the Custom Window. The first is the "Project/Help..." item, which pops 
  762. up  a  requester  box  describing the Custom Window. The other item is
  763. "Project/Quit", which will terminate the DiskSalv program.  
  764.  
  765.  
  766. 3. THE SCAN WINDOW 
  767.  
  768.           The Scan Window is entered once the user selected  the  Scan
  769. gadget  of the Input Window. In normal operation, the Scan window will
  770. have two gadgets, two menu items,  and  four  informational  displays.
  771. The "Stop"  gadget  will  cause the scan to stop where it is.  This is
  772. only available  for  Recover-by-Copy  operations,  since  Fix-In-Place
  773. operations need  to  scan  the  entire  disk.  The other gadget is the
  774. "Pause" gadget, which will freeze the scan where it is until  told  to
  775. go on.  
  776.  
  777.           The two menu items are "Project/Help..." and "Project/Quit". 
  778. The  former will display some information about the Scan Window, while
  779. the latter will cause the DiskSalv program  to  quit,  just  like  the
  780. Close gadget  will.  During Fix-In-Place operations, the Quit function
  781. will take some time if  invoked  during  some  of  the  latter  fixing
  782. phases,   since   DiskSalv  doesn't  want  to  leave  the  disk  in  a
  783. questionable state.  
  784.  
  785.           The "Current Operation" display indicates what  DiskSalv  is
  786. actually doing  at  any  given  time during the scan.  To the right of
  787. this  is  the  "Device  Scan"  box,  which  keeps  track  of  scanning
  788. statistics,  like  the  current  block  and  number of Files or Errors
  789. encountered.  Below this is the "fuel guage", which is always used  to
  790. indicate the  progress  of  the  current  phase.    Below  that is the
  791.  
  792.  
  793. DiskSalv Version 2 Release 11.27                               Page 13
  794.  
  795. "Scanning Results" display, which indicates the type and name of  each
  796. object found, as well as other statistics (this is basically what gets 
  797. written out  to  the  log  file,  if there is a log file).  On a large
  798. display, this is eleven lines long, on a small display its five  lines
  799. long.   The  QUICKSCAN  option  eliminates  this  part  of the display
  800. altogether.  
  801.  
  802.  
  803. 4. THE OUTPUT WINDOW 
  804.  
  805.           All Recover-by-Copy operations and  Fix-In-Place  operations
  806. with  corrupt  files  end  the  scanning  process  and open the Output
  807. Window. This is where objects and the output path are selected  for  a
  808. Restore (eg,  Recover-by-Copy)  operation.  This window's GUI consists
  809. of twelve gadgets and ten menu items.  The gadgets are as follows: 
  810.  
  811.      Salvage File List (etc) 
  812.           The scrolling file list, labelled somewhat  differently  for
  813.           each  function,  is where files are selected for restoration
  814.           to a new volume.  Clicking on a  file  or  link  alternately
  815.           tags  or  clears  that  object,  and  makes it the "current"
  816.           object  (displayed  in  the  text  gadget  below  the   list
  817.           gadget).   Clicking on a directory once makes it the current
  818.           object, but does not tag it.  Clicking again  on  that  same
  819.           directory   causes   this   "browser"   to  "move"  to  that
  820.           directory.  There are keyboard shorts for  this  too.    The
  821.           standard gadget short (shown in the list title), will scroll 
  822.           the  selected  item  in  the  list,  but  won't  actually do
  823.           anything with it.  The space bar will  toggle  selection  of
  824.           file objects, or enter directories.  
  825.  
  826.      Output Path 
  827.           This  specifies two gadgets, a disk icon gadget and a string
  828.           gadget.   Clicking  on  the  disk  icon  brings  up  a  file
  829.           requester,  while  clicking on the string requester lets the
  830.           user enter a path by hand.  This path is the  place  to  put
  831.           any recovered  files.    It  can  be a device, directory, or
  832.           possibly  a  "stream",  depending  on  the  setting  of  the
  833.           "Archive Stream"  option.    If  a non-existant directory is
  834.           specified, it is created.  
  835.  
  836.      Salvage 
  837.           This gadget begins  the  file  restoration.    It  won't  be
  838.           selectable until at least something is tagged in the Salvage 
  839.           List and proper output device parameters have been entered.  
  840.  
  841.      File List Action 
  842.           The  remaining  gadgets  are  part  of  the File List Action
  843.           group.  These control tags on objects,  browser  navigation,
  844.           and other  aspects  of the file list.  Note that only tagged
  845.           files are operated on by "Forget" or "Salvage".  
  846.  
  847.      Parent 
  848.           This gadget brings the file  browser  up  by  one  directory
  849.           level.  
  850.  
  851.      Root 
  852.           This  gadget  brings the file brower up to the top directory
  853.           level.  
  854.  
  855.      Forget 
  856.           This gadget removes any  tagged  objects  from  the  browser
  857.  
  858.  
  859. Page 14                               DiskSalv Version 2 Release 11.27
  860.  
  861.           list.  It has no effect on the object as it exists on-disk.  
  862.  
  863.      Info...  
  864.           Statistics  on  the  "current"  object  are  displayed  in a
  865.           requester when this is selected.  
  866.  
  867.      Select Directory 
  868.           This will recursively tag every object in the hierarchy of a 
  869.           directory.  If the current object is a directory, it's used, 
  870.           otherwise the present (displayed) directory is used.  
  871.  
  872.      Select Files 
  873.           Like "Select Directory", but tags only files.  
  874.  
  875.      Clear Directory 
  876.           Like "Select Directory", but recursively untags objects.  
  877.  
  878.      Clear Files 
  879.           Like "Clear Directory", but untags only files.  
  880.  
  881.           Most of the menu items are designed to support the  settings
  882. of different restore-time parameters.  The menu items are: 
  883.  
  884.      Project/Help...  
  885.           This  option  pops up with a brief description of the Output
  886.           window.  
  887.  
  888.      Project/New Device...  
  889.           This option resets DiskSalv and  starts  over  back  at  the
  890.           Input Window.  
  891.  
  892.      Project/Quit 
  893.           This  option,  like  the  close  gadget,  causes DiskSalv to
  894.           cleanly exit.  
  895.  
  896.      Settings/Size Check 
  897.           This toggles automatic size checking of the  output  volume.
  898.           Normally,  DiskSalv watches the size of the output volume to
  899.           have an idea ahead of time that a volume will fill up.  Some 
  900.           devices, such as RAM:,  are  dynamically  sized  and  always
  901.           indicate  full  when  asked,  so  this  parameter  is mainly
  902.           intended for such devices (DiskSalv  actually  invokes  this
  903.           automatically  for  RAM:,  but it would have to be specified
  904.           manually for other such devices).  
  905.  
  906.      Settings/Warning Notes 
  907.           This toggles whether or not DiskSalv will attach  a  warning
  908.           or error message, as a FileNote, to any file it restores via 
  909.           a  Recover-by-Copy  operation  that  it considers suspect or
  910.           bad.  
  911.  
  912.      Settings/Notes Restored 
  913.           This  toggles  restoration  the  original  FileNote  to  any
  914.           restored object.    Warning  notes  will  override  original
  915.           notes).  This option will inhibit such an action.  
  916.  
  917.      Settings/Protection Restored 
  918.           This toggles restoration of the original protection codes on 
  919.           any object.  This option will inhibit such an action.  
  920.  
  921.      Settings/Date Restored 
  922.           This toggles restoration of the original  AmigaDOS  date  to
  923.  
  924.  
  925. DiskSalv Version 2 Release 11.27                               Page 15
  926.  
  927.           all output objects.  
  928.  
  929.      Settings/Archive Stream 
  930.           This  determines  which I/O formation is used for the output
  931.           device.  By default, the OUTPUT device is a  directory,  and
  932.           DiskSalv  regenerates  the specified directory tree as found
  933.           on the input  disk.    When  Archive  Stream  mode  is  set,
  934.           DiskSalv  writes  out  everything  in  a  structured  output
  935.           stream.  This stream is turned back to a directory  tree  by
  936.           using  the Project/Restore option on the Input Window. Since
  937.           this formatted stream makes all disk  objects  appear  as  a
  938.           single  file,  it  can be piped though compression tools and
  939.           processed through other interesting programs as desirable.  
  940.  
  941.      Settings/Save Settings 
  942.           When selected, this saves the state of  the  toggle  options
  943.           other than "Archive Stream" out to the DiskSalv.info file.  
  944.  
  945.  
  946. 5. THE RECOVERY WINDOW 
  947.  
  948.           The  Recovery  Window  looks  exactly  like the Scan window,
  949. mainly because it is the Scan Window just doing something else.   This
  950. window  displays  each  file  as  it's  restored to the output device.
  951. Along the way, if the output device fails or gets full, DiskSalv  will
  952. prompt  the  user  to  skip  the  file,  change  the  media, or change
  953. devices.  When a device change is  requested,  the  Output  window  is
  954. called up  again to secure a new device input the normal way.  At that
  955. point, only files left yet-to-be restored will be out on disk.  
  956.  
  957.  
  958. 6. LICENSING AND DISTRIBUTION 
  959.  
  960.           This program is distributed as ShareWare. It may  be  freely
  961. redistributed,  but  no  charges  other  than  reasonable  copying and
  962. handling fees may be collected.  The suggested basic registration  fee
  963. is US$10, which gets you an entry in my database of users.  
  964.  
  965.           The  semi-commercial version is available for US$40 (release
  966. expected in August of 1993), and it comes with a professional  quality
  967. manual,  AmigaGuide manual, and the latest version of DiskSalv on disk
  968. as well, along with an update when ready.  At present, the  commercial
  969. and  shareware  versions  of  the  program are the same, though at any
  970. given point, the commercial version will of course be the very  latest
  971. release available.  
  972.  
  973.           Finally,  if  you  want an update service, for an additional
  974. US$10 (US$15 foreign) you get a year's  worth  of  updates,  at  least
  975. two.   If  no  bug  fixes  are  done  during  that time, you'll get an
  976. enhanced version when it is released.  This is mainly  to  keep  those
  977. concerned about any bugs fed with the latest version automatically.  
  978.  
  979.           The  place  to  send any and all inquirys, bug reports, etc.
  980. is: 
  981.                     Dave Haynie
  982.                     284 Memorial Avenue
  983.                     Gibbstown, NJ 08027
  984.                     USA
  985.  
  986.                     You can also contact me electronically:
  987.                               UUCP:    daveh@cbmvax.commodore.com
  988.                               Usenet:    {uunet,rutgers}!cbmvax!daveh
  989.  
  990.  
  991. Page 16                               DiskSalv Version 2 Release 11.27
  992.  
  993.                               BIX:        hazy
  994.                               Portal:        hazy
  995.                               FAX:        +1 (609)224-0442
  996.  
  997.           If you're not from the  USA,  you  can  pay  in  your  local
  998. currency if  you  send  a  cash  equivalent.  The extra expense of you
  999. getting a  draft  for  US  currency,  then  me  paying  the  bank  for
  1000. collection, seems to leave the banks getting about 1/2 the money for a 
  1001. US$10 registration fee.  I'd just as soon convert the cash myself once 
  1002. I collect  a  reasonable  amount.    Of course, if your country's laws
  1003. prohibit sending cash out of the country or something similar, you may 
  1004. not want to do this.  
  1005.  
  1006.           Also  of  interest  to  foreign  Amiga  users  is   language
  1007. support.   DiskSalv  fully  supports  the  AmigaDOS  2.1  localization
  1008. library mechanism.   Some  locale  catalogs  are  included  with  this
  1009. initial release.    Additional locale support should be available at a
  1010. later date.  Translations of the commercial manual  may  be  possible,
  1011. but none are currently being developed.  
  1012.  
  1013.           If  you're  a  commercial interest, you can contact me about
  1014. non-exclusive bundling deals if you're interested.  Dealers  or  other
  1015. groups  should  contact  me  about  volume  discounts  on  the  deluxe
  1016. distribution.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.